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X86-to Tapestry transition exception handler ^ 

II This handler is entered under the following conditions: 
// 1. An x86 caller invokes a native function 
// 2. An x86 function returns to a native caller 

// 3. x86 software returns to or resumes an interrupted native function following 
// an external asynchronous inten"upt, a processor exception, or a context switch 
^321 

dispatch on the two least-significant bits of the destination address { 
case"00" // calling a native subprogram 

// copy linkage and stack frame information and call parameters from the memory 

// stack to the analogous Tapestry registers 

LR -^[SP++] // set up linkage register^^^^ . 
AP-»-SP //address of first argument-^"^"^^ 325 f3 

SP SP - 8 // allocate retum transfer argument area 007 
SP-^-SP&(-32) // round the stack pointer down to a 0 mod 32 boundary ^-^^^ 
XD-^ 0 // inform callee that caller uses X86 calling conventions 328 

case "01" // resuming an X86 thread suspended during execution of a native routine . ^ 
if the redundant copies of the save slot number in EAX and EDX do not match or if 1 . 
the redundant copies of the timestamp in EBX:ECX and ESI:EDI do not match { J 
// some form of bug or thread corruption has been detected 
goto TAPESTRY_CRASH_SYSTEM( thread-corruption-error-code ) ^ 372 

save the EBX:ECX timestamp in a 64-bit exception handler temporary register lo^,, I 
(this will not be overwritten during restoration of the full native context) J f 
use save slot number in EAX to locate actual save slot storage--v_374 
restore full entire native context (includes new values for all x86 registers) 
if save slot's timestamp does not match the saved timestamp { "^375 
// save slot has been reallocated; save slot exhaustion has been detected 
goto TAPESTRY_CRASH_SYSTEM( save-slot-overwritten-error-code )^o7- 

free the save slot " 

case"10" // returning from X86 callee to native caller, result already in registers 

RV0<63:32> -^edx<31 :00> // in case result is 64 bits ^333 

convert the FP top-of-stack value from 80 bit X86 form to 64-bit form in RVDP "^^^004 1 
SP -^ESI // restore SP from time of call^- — 337 

case"11" // returning from X86 callee to native caller, load large result from memory ■ 

RV0..RV3 ^ load 32 bytes from [ESI-32] // (guaranteed naturally aligned) -v. . I 00. 
SP— ESI // restore SP from time of call "^^"^ 

} 

EPC-^EPC&4 //reset the two low-order bits to zero ^ 
RFE^,,„ 336 
^338 
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340 

/ 

Tapestry-to-X86 transition exception handler 

// This handler is entered under the following conditions: 

// 1. a native caller invokes an x86 function 

// 2. a native function returns to an x86 caller 

switch on XD<3:0>{ -\ 

^ ^341 

XD_RET_FP: // result type is floating point 

FO/FI — FINFLATE.de( RVDP) // X86 FP results are 80 bits 
SP^ from RXA save // discard RXA, pad, args 

FPCW-^image after FINIT & push // FP stack has 1 entry 
goto EXIT 

XD_RET_WRITEBACK: // store result to @RVA, leave RVA in eax 

RVA-*-from RXA save // address of result area 

copy decode(XD<8:4>) bytes from RV0..RV3 to [RVA] L 342 

eax-^ RVA // X86 expects RVA in eax 

SP^from RXA save // discard RXA, pad, args 

FPCW-^image after FINIT // FP stack is empty 

goto EXIT 

XD_RET_SCALAR: // result in eax:eda 

edx<31 :00> eax<63:32> // in case result is 64 bits 
SP-^from RXA save // discard RXA, pad, args 

FPCW-»-image after FINIT // FP stack is empty j 

goto EXIT 

XD_CALL_HIDDEN_TEMP: // allocate 32 byte aligned hidden temD^343 
esi-^SP // stack cut back on return — ^ 

SP^ SP - 32 // allocate max size temp "1 344 

RVA-^SP //RVAconsumed later by RR J 

LR<1:0>-^"11" //flag address for return & reload^ 

gotoCALL.COMMON 345 

default: // remaining XD_CALL_xxx encodings 

esi-^SP // stack cut back on return 

LR<1 :0> -^"10" // flag address for return 343 

CALL.COMMON: 347 ^346 

interpret XD to push and/or reposition args 
[-SP] LR // push LR as return address 

EXIT: 

setup emulator context and profiling ring buffer pointer 
} ^349 

RFE II to original target 

FIG. 31 



348 



350 

interrupt/exception handler of Tapestry operating system: ^ 
II Control vectors here when a synchronous exception or asynchronous interrupt is to be 
// exported to / manifested in an x86 machine. 

// The interrupt is directed to something within the virtual X86, and thus there is a possibility 
// that the X86 operating system will context switch. So we need to distinguish two cases: 
// either the running process has only X86 state that is relevant to save, or 
// there is extended state that must be saved and associated with the current machine context 
// (e.g., extended state in a Tapestry library call in behalf of a process managed by X86 OS) 
if execution was Interrupted in the converter - EPC.ISA == X86 { 1 

// no dependence on extended/native state possible, hence no need to save any [-351 
goto EM86_Deliver_lnterrupt( interrupt-byte ) J 
} else if EPC.Taxi_Active { 

// ATaxi translated version of some X86 code was running. Taxi will rollback to an ^ 
// x86 instruction boundary. Then, if the rollback was induced by an asynchronous external 
// interrupt, Taxi will deliver the appropriate x86 interrupt. Else, the rollback was induced 
// by a synchronous event so Taxi will resume execution in the converter, retriggering the 
// exception but this time with EPC.ISA == X86 
goto TAXi_RoIlback( asynchronous-flag, Interrupt-byte ) 
}elseifEPC.EM86{ ^ 
// The emulator has been interrupted. The emulator is coded to allow for such 
// conditions and permits re-entry during long running routines (e.g. far call through a gate) 1 354 
// to deliver external interrupts [ 
goto EM86_Deliver_lnterrupt( interrupt-byte ) J 



>353 



} else { 



// This is the most difficult case - the machine was executing native Tapestry code on ^ 
// behalf of an X86 thread. The X86 operating system may context switch. We must save 
// all native state and be able to locate it again when the x86 thread is resumed. 
^361 

allocate a free save slot; if unavailable free the save slot with oldest timestamp and try again 
save the entire native state (both the X86 and the extended state) T 
save the X86EIP in the save slot J'^°^ 353 

overwrite the two low-order bits of EPC with "01 " (will become X86 interrupt EIP) ^ V 360 
store the 64-bit timestamp in the save slot, in the X86 EBX:ECX register pair (and, \^^. 

for further security, store a redundant copy in the X86 ESI:EDI register pair) 
store the a number of the allocated save slot In the X86 EAX register (and, again for "i . . 

further security, store a redundant copy in the X86 EDX register) j 365 

goto EM86_Deliver_lnterrupt( interrupt-byte ) -n 

^369 
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typedef struct { 

save_slot_t * newer, // pointer to next-most-recently-allocated save slot\ 

save_slot_t * older; // pointer to next-older save slot |379c 

unsigned int64 epc; // saved exception PC/IP ^ 

unsigned int64 pew; // saved exception PCW (program control word) I 

unsigned int64 registers[63]; // save the 63 writeable general registers r^^" 

// other words of Tapestry context J 

timestampj timestamp; // timestamp to detect buffer overrun -n 

int save_slot_ID; //ID number of the save slot ^ 358 

boolean save_slot_is_full; // full /empty flag > 357 
} save_slot_t; ^359 J 

save_slot_t * save_siot_head; // pointer to the head of the queue ^ 

save_slot_t * save_s!ot_tail; // pointer to the tail of the queue ^379a 

^379b 
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DDADC n/CWT DIT 
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ULBPROBE 
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OR 

EMUIATOR PROBE 




0.0000 


DEFAULT (x86 TRANSPARENT) EVENT,REUSE ALL CONVERM VALUES 


YES 




NO 




REUSE EVENTCODE 




0.0001 


SIIIPLEX85 INSTRUCTION COMPLETION (REUSE EVENTCODE) 


YES 




NO 




REUSE EVENTCODE 




0.0010 


PROBEEXCEPTIONFAILED 


YES 




NO 




REUSE EVENTCODE 




0.0011 


PROBEEXCEPTIONFAILE0,RELOADPR0BETIMER 


YES 




NO 




REUSE EVENTCODE 




0.0100 


aUSHEVENT 


NO 


NO 


NO 


NO 






0.0101 


SEQUENTy\L; EXECUTION ENVIRONMENT CHANGED -FORCE EVENT 


NO 


YES 


NO 


NO 
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FAR RET 


NO 


YES 


YES 


NO 






0.0111 


IRET 


NO 


YES 


NO 


NO 


■ 


V 


0.1000 


FARCALL 


NO 


YES 


YES 


YES 


FARCALL 




0.1001 


FARJMP 


NO 


YES 


YES 


NO 


• 




0.1010 


SPECWL;EMUlATOR EXECUTION, SUPPLyEXTRAINSTRUCTIONDATA" 


NO 


YES 


NO 


NO 


■ 




0.1011 


ABORTPROFILE COLLECTION 


NO 


NO 


NO 


NO 


• 




0.1100 


x86SyNCHRONOUS/ASYNCHRONOUSINTERRUPTW/PROBE(6RP0) 


NO 


YES 


YES 


YES 


EMMPR03E 




0.1101 


x86SYNCHRONOUS/ASYNCHRONOUSINTERRUPT[GRP0) 


NO 


YES 


YES 


NO 


• 




0.1110 


X86SYNCHRONOUS/ASYNCHRONOUS INTERRUPT W/PR0BE(GRP1) 


NO 


YES 


YES 


YES 


EMMORPROBE 




0.1111 


x86SyNCHRONOUS/ASYNCHR0NOUSINTERRUPT(6RP1) 


NO 


YES 


YES 


NO 


• 




1.0000 


IP-REIATIVE JNZ FORWARD (OPCODE: 75, OF 85) 


NO 


YES 


YES 


NO 






1.0001 


IP-REIATIVE JNZBACKWARD(0PCODE ?5, 0F85) 


NO 


YES 


YES 


YES 


JNZ 




1.0010 


IP-REIATIVE CONDmONAL JUMP FORWARD ■ (JCC, JCXZ, LOOP) 


NO 


YES 


YES 


NO 






1.0011 


IP-REWTIVE CONDITIONAL JUMP BACKWARD • (JCC, JCXZ, LOOP 


NO 


YES 


YES 


YES 


CONDJUMP 

wwi \y vvtiit 




1.0100 


IP-RElATIVE,NEARJMPFORWARD (OPCODE: E9.EB) 


NO 


YES 


YES 


NO 






1.0101 


IP-REIATIVE, NEAR JMP BACKWARD (OPCODE: E9, EB) 


NO 


YES 


YES 


YES 


NEAR JUMP 


V 
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RET/RETIMM16(OPCODEC3,C2/W) 


NO 


YES 


YES 


NO 






1.0111 


IP-REIATIVE, NEAR CALL(0PC0DE:E8) 


NO 


YES 


YES 


YES 


NEARCALL 




1.1000 


REPE/REPNECMPS/SCAS(0PC0DE:A6.A/.AE,AF) 


NO 


YES 


NO 


NO 






1.1001 


REPMOVS/STOS/LD0S(0PCO0E:M,A5,AA,AB,AC,AD) 


NO 


YES 


NO 


NO 






1.1010 


INDIRECTNEARJMP(OPCODE:FFM) 


NO 


YES 


YES 


NO 
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